Creating Endpoints

Endpoints specify the location from which FintechOS APIs can access the resources they need to carry out their function. They play a key role in guaranteeing the correct functioning of the software that interacts with it.

You can add an endpoint, attach security roles, attach an automation script to it, then on digital journeys or data forms call action to it.

You can add endpoints either from the from Endpoints List page, or from the Edit Server Automation Script page, Endpoints section by clicking the Insert button. The Script field will be prefilled with the name of the automation script for which you create the endpoint.

Step 1. Create an endpoint

This section describes how to add an endpoint from the Endpoints page:

  1. From the menu, click Advanced > Endpoints. The Endpoints List page appears.
  2. At the top-right corner of the page, click the Insert icon. The Add Endpoint page appears.
  3. In the Name field type the name of the endpoint which will be used by the system.
  4. In the Display Name field, type the name of the endpoint which will be displayed on the button in the user interface.
  5. (Optionally)If you are working with actions groups, from the Action Group field, select the desired action group you have previously created. For more information on action groups, see Defining Action Groups.
  6. From the Script drop-down, select the on-demand automation script you previously created.

  7. At the top-right corner of the page, click the Save and close icon to save the endpoint or Save and reload to attach a security role to the endpoint.

You can now go to the digital journey or data form and call action to the server automation script.

Step 2. Attach security role to an endpoint

For higher security, you can now choose which security roles have the privileges to call actions on endpoints.

When calling actions on endpoints which have no security roles attached, errors will occur and the actions will not be performed.

NOTE  For backwards compatibility, the security role “Registered Users“ is automatically added to all endpoints created in previous versions of FintechOS Studio.
IMPORTANT!  The security role “Registered Users“ that is automatically added to all endpoints created in previous versions of FintechOS Studio does not ensure the backwards compatibility for unauthenticated portals. In this case, you need to manually configure or import the security roles assignment.

To attach a security role to an endpoint:

  1. Go to the endpoint configuration page (Edit Endpoint page), scroll down to the SECURITY ROLES section and click the Insert existing button. A window appears which lists all defined security roles.
  2. Select one from the list by double-clicking on it or add a new security role (click the Insert button and provide all details required to add a new security role). The selected security role displays in the SECURITY ROLES section.

  3. At the top-right corner of the page, click the Save and close icon to save the endpoint or Save and reload to attach a security role to the endpoint.